Canigó - Detall dels tags - gridBagLayout

Detall dels tags - gridBagLayout

Defineix una quadrícula per distribuir els tags que contingui en columnes i files. Es composa de tantes columnes com es defineixin i les files que calguin per encabir-hi els tags que contingui.

La documentació auto-generada del tag és a http://canigo.ctti.gencat.net/confluence/canigodocs/site/canigo2_2/tlddoc/fwk/gridBagLayout.html

Atributs específics de Canigó

Atribut Funció
colspan Permet especificar un colspan per algunes de les cel.les. La sintaxi per especificar les cel.les és la mateixa que per l'atribut style
gridBorder Defineix la vorera de la Taula
gridClass Defineix la classe CSS que s'aplica a la Taula
gridStyle Permet definir estils que s'apliquen a la taula que s'utilitza per construir el grid. Per exemple, gridStyle="border:1px solid green"
gridStyleId  
onchange  
onclick  
ondblclick  
onfocus  
onkeydown  
onkeypress  
onkeyup  
onmousedown  
onmousemove  
onmouseout  
onmouseover  
onmouseup  
rowspan Permet especificar un rowspan per algunes de les cel.les. La sintaxi per especificar les cel.les és la mateixa que per l'atribut style
size Defineix el tamany del grid. El format és size="num_files,num_columnes" i ha de coincidir amb el número d'elements que s'inclouen dins del tag.
style Permet definir estils que s'apliquen a files o cel.les individuals de la taula.
styleClass Defineix la classe CSS que s'aplica a files o cel.les individuals de la taula. La sintaxi per especificar les files o cel.les és la mateixa que per l'atribut style.

Notes d'us

Cal especificar exactament el número de files i columnes que s'ompliràn i que aquesta quantitat coincideixi amb el número d'elements continguts.

El layout s'omple per files, d'esquerra a dreta.

L'atribut style permet definir propietats aplicades a elements concrets (files, columnes o cel.les) de la taula. La sintaxi per especificar l'element és la següent:

Valor aplica a
f:c=estil la cel.la en la fila f i columna c
*:c=estil totes les cel.les de la columna c
f:*=estil totes les cel.les de la fila f
:=estil totes les cel.les de la taula
f:**=estil la fila f (el TR, no les cel.les individuals)
:*=estil totes les files de la taula (els TR, no les cel.les individuals)

atenció: la numeració de les files i columnes comença per 0.

Aquest layout no és compatible amb el mecanisme que implementen la majoria dels tags per generar de forma automàtica una etiqueta que precedeixi al camp, sense necessitat d'utilitzzar un tag específic.

Si s'utilitza el gridBagLayout cal que tots els tags tinguin layout=false i les etiquetes s'han de crear explícitament amb el tag fwk:label

Exemple

A continuació es presenta un fragment de pàgina que utilitza el tag fwk:gridBagLayout

L'exemple crea un layout amb dues files i quatre columnes. Dues de les cel.les s'omplen amb un espai en blanc.

Pàgina JSP

<%@ include file="/WEB-INF/jsp/includes/fwkTagLibs.jsp" %>

<fwk:form action="provesTagsLayout.do"
          styleId="myActionForm"
          key="jsp.provesTags.ProvesTagsSimple.form"
          reqCode="show"
          layout="false"
          method="post">

    <fwk:gridBagLayout gridStyleId="grid"
                       size="2,4"
                       gridStyle="border:1px solid green"
                       style="0:0=color:red;background-color:yellow,*:2=color:blue;background-color:yellow">

        <fwk:label styleId="nameLabel"
                   key="jsp.provesTags.ProvesTagsSimple.lbl1"
                   id="camp1"
                   styleClass="label"/>
        <fwk:text key="jsp.provesTags.ProvesTagsSimple.camp1"
                  styleId="camp1"
                  mode="E,E,E"
                  layout="false"
                  styleClass="fieldText"
                  maxlength="10"
                  size="10"
                  property="camp1"/>

        <fwk:label styleId="nameLabel"
                   key="jsp.provesTags.ProvesTagsSimple.lbl2"
                   id="camp1"
                   styleClass="label"/>
        <fwk:text key="jsp.provesTags.ProvesTagsSimple.camp1"
                  styleId="camp1"
                  mode="E,E,E"
                  layout="false"
                  styleClass="fieldText"
                  maxlength="15"
                  size="15"
                  property="camp1"/>

        <span>&nbsp;</span>
        <span>&nbsp;</span>

        <fwk:label styleId="nameLabel"
                   key="jsp.provesTags.ProvesTagsSimple.lbl3"
                   id="camp1"
                   styleClass="label"/>
        <fwk:text key="jsp.provesTags.ProvesTagsSimple.camp1"
                  styleId="camp1"
                  mode="E,E,E"
                  layout="false"
                  styleClass="fieldText"
                  maxlength="8"
                  size="8"
                  property="camp1"/>
    </fwk:gridBagLayout>
</fwk:form>

Arxius d'internacionalització

Els elements de layout no son visibles i, per tant, no tenen textes asssociats.


Attachments:
fwk_gridBagLayout.jpg (image/jpeg)
fwk_gridBagLayout.jpg (image/jpeg)